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Ihe RIKKE BCPL System 



This document is a users manual to the BCPL operating-system on 
RIKKE. 

The first 7 chapters of the manual are updated versions of 

The RIKKE BCPL System, 
A Programmer's Manual 

DAIMI MD-22, Februar 1976 

by E j vi nd Lynni ng 

The next 4 chapters describe the file-system, and are totally new. 

The purpose of the document is to serve both as a users manual for 
the ordinary user, and as a reference handbook for the system 
programmer- 

No attempt has been made to describe implementation details; 
however the source text of all system programs are available - and 
readable - and should together with this paper provide enough in- 
formation for future system programmers to modify and extend the 
system. 

DAIMI MD-38, September 1980 



Jens Kristian Kjsergaard 
Flemming Wibroe 
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1- Introduction. 



The RIKKE BCPL system is an interactive single-user operating 
system which Loads and executes BCPL programsCIJ in an environment 
providing a range of facilities for hierarchical process or- 
ganization, storage allocation, and input/output. It is a variant 
of the Oxford OS system C2,3] . 

(Througout this manual Lil will refer to reference i in the 
reference list, whereas -Ci> or -C j - k > will be used for cross 
references to other sections within the manual itself.) 

Parts of the system are implementations of OS concepts, though not 
generally verbatim copies, from the Oxford code. It should be easy 
to modify programs that run under OS to run under the RIKKE BCPL 
system. 

The system has been designed to be highly interactive; thus its 
basic loop is not a load-go loop, as in OS, but a command inter- 
preter loop, and a significant part of the system has been devoted 
to facilities for interactive debugging and analysis of running 
programs . 

The system runs on the RIKKE OCODE machine, which is implemented 
by means of a micro-programmed emulatorC43, and uses the micro- 
programmed i/o-nucleusC5U. RIKKE itself is described in C6U. 

The first seven sections introduce various important concepts in 
the system. For most of these a familiarity with C2,3H would be 
helpful, although not absolutely necessary. 

The next 3 sections describes the command interpreter, the file 
system, how to use it, and gives a list of all library routines 
ava i lab le . 



In chapter 11 all the system-programs available to the users are 
described, and finally the internal ASCII-character and a 
DeadStart guide set is given. 
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2- Storage utilization. 



The Linear store of the OCODE machine, 64K 16-bit words, is 
divided into the following areas: the global vector, the data 
area, the stack, and the code area. Each separately compiled seg- 
ment of BCPL program contains a code block, which is loaded into 
the code area, and a data block, containing statics and strings, 
which is loaded into the data area. The code area is treated as a 
stack, whereas the data area is managed by the free store system, 
described below. The overall organization of storage is il- 
lustrated in fi g . 2 .1 



Organisation of storage 



Register 
LIMIT — > 



WLIMIT — > 



-> + 



S — > 

P — > 

PO — > 



Desc r ip.ti.on 



code- 
area 



+ <-- stack- 
limit 



current 
stack 
f r ame 



st ack- 
area 



data- 
area 



g I obal 
ve ct or 



BASE,G --> +- 



fig. 2.1 
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The space between the T and w* LI MIT registers is to allow the 
system to react nicely to a stack overflow situation. These two 
registers are administered by the loader and unloader, and it is 
seen that a trade-off exists between the amount of code that may 
be loaded at any given time and the available stack area. By the 
philosophy of the system all major blocks of storage required by a 
program should be claimed from the data area using the free store 
system. Thus the stack size is ordinarily a measure of the amount 
of recursion used rather than of data storage requirements. 

In order to allow optimal use of the storage resources of the 
system, a facility (the setPO command) to change the stackbase ( PO 
register) has been included. This can be used to accommodate 
programs with heavy demands on either static data or dynamic data, 
but not both. The default value of PO is 30000(dec i ma I) . 

The global vector has been placed so that global numbers equal ab- 
solute machine addresses; this is useful to know if one wishes to 
dump the value of a particular global interactively. 

The code area is wr i te-protect ed to avoid accidental overwriting, 
particularly of system code. The registers can only be overwrit- 
ten by system kernal routines. This enhances the robustness of 
the system; however by overwriting essential globals or system 
stream vectors in the data area, it is easily possible to crash 
the system total ly . 

1"1- IJ]§ ££§£ Store System. 

The free store system is described in C23. It provides a general 
facility for claiming and returning vectors (blocks, arrays) of 
storage using the routines NewVec and ReturnVec,. 

The lifetime of such a vector is independent of the stack 
discipline for procedure entry and exit, i.e. a vector claimed 
using NewVec lives until it is returned by ReturnVec, unless a 
fJQish occurs before this takes place -C4>. 

$( le.t v=NewVecCn3 yields in v a pointer to a vector of length 

n + 1 ( v ! th rough v ! n) . 



ReturnVec Cv, nU 



returns this vector. 



$( J^et n = MaxVec SizeCD yields in n the length of the largest 

vect or ava i lab le . 

It should be noted, that the system does no sort of Garbage Col- 
lection, so a great deal of fragmentation can arise. 



2.1 
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3- Loading §D^ Unloading. 



There are two ways to Load code, either via the command inter- 
preter or under program control. 

Code Loaded under program control may be explicitly unloaded, or 
will be automatically unloaded when the Run-C4>, in which it was 
loaded, terminates. 

Using the command interpreter to execute a program the users code- 
module will be loaded and unloaded automatically. The name of the 
code-module will by the command interpreter be interpreted as a 
directive to load and execute the code-C8>. 



3-1- Information Blocks and Overlaps. 

For each segment of code loaded, an information block is kept in 
the data area. It describes the code and data blocks and is used 
for unloading. Information blocks are chained together to reflect 
the last- i n-f i rst-out discipline enforced on loaded code. Global 
425, IBlock, always points to the most recently created, still ex- 
isting information block. An IBlock value is used as a parameter 
to Unload to determine where. to stop unloading. 

Overlaying may be necessary for large programs due to the limited 
size of storage. It may be accomplished as follows: 



$( let SaveIB=IBlock 
LoadC'ove r lay"] 
Proc Cpve cD 
UnloadCSavelBH 

$) 



// call of routine "Proc" in "overlay" 



However, it may be more natural to use the Run-mechanism, thereby 
avoiding explicit unloading. A small steering routine, which loads 
and calls the overlay, should then be used as the argument of Run: 



RunCSteer,pve c] 



// call of Run 



let Steer(pvec) be 
$(" 

LoadC'over I ay "D 

Proc CpvecD 
$) 



// call of routine "Proc" in "overlay" 



3.1 
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3-2. Globals. 

The discipline used for globals with respect to Loading and un- 
loading is as described in C2D . 

During the loading of a code segment, its global entry points are 
calculated and assigned to the proper globals. At the same time 
the old values of these globals are remembered, so that they may 
be restored when the segment is unloaded. 

Immediately after system setup, all globals are saved in the 
protected code area. The saved values are written back by the 
reset command-C8>, which also restores the code and data areas to 
their initial states. It may be called via the command inter- 
preter . 



3.2 
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k' Ii3£ EyQ""^§£i3^Qisdi» 



For a philosophical discussion of the Run-mechanism, consult C2] . 
In short, Running a routine (program) means: saving the state of 
the system, and then calling the routine so that when a finish oc- 
curs, its effect will be to restore the system in the saved state 
and continue execution from the point where Run was called. 

In the hierarchical structure of a process Run may be used to mark 
and save general return points; it establishes Run -levels. 

The notion of a state of the system to be saved and restored is 
explained in the following. 

The Free Store Sy st em-C2 .1 > : 

When a Run is terminated (either by finish or merely returning) 
all storage claimed in that Run is forcibly returned. This is 
accomplished by initiating for each Run its own free store 
within the largest available vector and simply abandoning it 
wholesale when Run term i nat es . Thus after Run returns, the free 
store will be exactly as it was when Run was called. It is not 
possible inside a Run to return storage that was claimed at an 
outer Run- leve I . 

PutBack-C7 -1>: 

Items put back to streams do not survive across Run-boundaries, 
either into or out of a Run. 



Loaded Code-C3>: 

All code loaded 
mi nates . 



inside 



Run is unloaded when the Run ter- 



4.1. The C iearUeChain - 

Certain activities in the system or in a user program may require 
a terminating action, e.g. the writing of a file via a stream must 
be terminated by closing the stream. Such terminating actions may 
be forgotten in an error situation, or the user may even fail to 
include them in his program. To avoid possible nasty consequences, 
they may be placed in the Cj-earUgGha in, in which case the system 
will see to, that they are carried out when the Run terminates. 
Notice that failing programs which give up cause termination of a 
Run. 

The ClearUpChain is a list of two word blocks, each containing a 
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pointer to the next block, and a routine entry point: 

C LearUp Cha in 



C LearUpChain 



| — +— >| — + ~ >| 
, , | | 

| CURoutinel | | CURoutine2 | 



I I 

| CURoutine3 | 



fig. 4.1 



The cLearup blocks, initialized to contain routine GURoutine, is 
entered in the CiearUgCha in by the call Ent erCUC ECU, where C is 
the address of the clearup block, and when the corresponding ac- 
tivity terminates normally, it should be removed by RemgveCUC ECU . 
However, if this is not done before the Run terminates, the 
general clearup routine will call CURout i neCCD . 

Notice that the two word block must be allocated by the program 

which uses the clearup facility, not by EnterGUC, and in fact it 

should be placed so that its address (C) informs CURoutine of ex- 
actly what it is to do. 

The exact relationship of the ClearUpChain to the Run-mechanism is 
the following: 

When a new Run is started, the handle of the ClearUpChain is 
stored, and a new, empty, ClearUpChain is initiated. When a Run 
terminates, all orders in the current ClearUpChain are obeyed, and 
the saved handle is used to reestablish the old situation. 
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5- Irags. 



A general facility exists in the system for handling traps, i.e. 
situations when the normal flow of execution must be interrupted 
for some reason. 



SL-1" Icae Conditions. 

The following situations cause traps to occur: 

1. The OCODE emulator detects 

a) an error, e.g. stack overflow, or 

b) a routine or function entry while the trace facility 
■C6.1> 

is sw i t ched on . 



2. A system or user program detects a software failure. Upon 
detection of irreparable failure or merely a situation which 
might interest the operator sufficiently to engage him in con- 
versation, any program may call StogC F, p1 , p2, . . . -D, which 
generates a trap. Stop displays its parameters on the console 
with the same parameter convention as OutF -C7.8> 

A failing program may also merely give up, i.e. call 
GiveUgCF,p1 , p2, p3 , . . .3, which displays the message F with 
parameters as OutF, and finish. 

3. An i / o- i nte r ru pt . This is used for the console keyboard to al- 
low the operator free interference with program execution. 
Other devices do not interrupt the system. 

4. Actual operator interruption. The routine which is invoked by 
the general trap handler in case 3 usually just appends the in- 
coming character to a buffer, but two characters have special 
ef f e ct s : 

a) CTRL C causes a call of Stop, cf. case 2. The same ef- 
fect may be obtained by switching KA off and on again. 

b) CTRL E causes a call of global 8, Interrupt -C6.2>. 

c) CRTL R displays the keyboard buffer contents on the con- 
sole 

d) CTRL S, CTRL Q and CTRL are used to control the Console 
output -C7 -3> . 



Other i/o-streams may be set up to include the interrupt 
facilities. When a transfer of a block of information is com- 
pleted by the IOnucleous, the devi cedependent interrupt handler, 
which is inserted in the Interrupt vector, will be executed. 

The system function Al I oc int Ent r^( Int-hand ler) inserts the routine 

5.1 
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Int-hand le r in an interrupt vector an returns a value, which must 
be placed in an i/ o-cont ro lb loc k-C5> . 



5-1- Ihe Irag Handler. 

The task of the general trap handler is to distinguish among these 
cases and take proper action. In cases 1 .b, 3, and 4.b it suffices 
to call a further routine to handle the situation; in all other 
cases the operator is consulted, i.e. a message is displayed on 
the console, and a command interpreter loop entered. When used in 
this manner, in a trapped context, the command interpreter accepts 
a set of commands which differs somewhat from that accepted in an 
ordinary, not-trapped context-C8>. 

For the curious reader we add, that to carry out its task, the 
trap handler needs to know the values of the OCODE machine 
registers, the context block, at the time of trap. When the 
emulator encounters an error, it places the register values on the 
stack, inside a frame it sets up for the Trag routine, and then 
generates a call to it. 

Stop, not knowing the register contents, guesses them as best it 
can, places them appropriately, and transfers control to Trap by a 
goto, so that its own stack frame becomes that of Trap. For all 
this to work, both the emulator and Stop must know the way in 
which Trap references its local variables. The scheme then works 
in complete harmony with the stack architecture of the OCODE 
machine; in particular nested interrupts are merely recursive 
calls of Tr apC93 . 



5.2 
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6- Interaction. 



A major design aim of the system has been to facilitate user in- 
teraction with running programs. The tools supplied for this pur- 
pose are the following, 

6-1" IJ]§ Il§ce Facility- 
All routine and function entries (with parameters), that are com- 
piled with trace-option tM , may be traced on the line printer. 
This facility is controlled by the trace command, which takes a 
boolean parameter to switch the trace on (true) or off (false) - 

6-2- The User Interrupt Routine. Ea£iii£)£- 

Along with any program a routine may be included which can be cal- 
led asynchronously by typing CTRL E on the keyboard- The routine 
may for example be used to monitor the program by displaying im- 
portant information or to control program behaviour according to 
further interactive commands- It must be declared as global 8 (In- 
terrupt )-C5 .1 >. 

6-3- The Command Interpreter. 

If the system is trapped by an emulator or system error, a user 
program call of Stop, or CRTL C typed on the keyboard, a special 
command interpreter loop is entered-C8>. In the case of emulator or 
system errors it is not recommended to use the cont command; 
rather reset or end should be .given after debugging information 
has been obtained. 

In exploring the state of a program the stack and dump. commands 

are particularly useful. In such a situation it is often useful to 

be familiar with the anatomy of a stack frame, which is therefore 

shown in fig. 6.1 : 



6.3 
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A stack frame 



Thi s Rout i ne 



Return addr. 
Ret u rn Link 



< s register 

anonymous variables 



Local variables in order 
of declaration; vec-dec- 
laration may confuse 



par amete rs 



< p register 



fig. 6.1. 



The P register corresponds to the value of level displayed by the 
stack command . 



6.3 
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Streams . 



The apparatus for i/o in the system consists of streams C23. A 
stream is either an input stream or an output stream. There 
exists a set of primitives applicable to all streams; these 
primitives are implemented as global routines. 



I"l" Stream Primitives. 

For input s t reams : 

Next. 
$( let x=NextCS3 yields in x the next item from stream S. 

Endof. 

EndofCSH has value true if the end of stream S has been reached, 
i.e. if no more items can be obtained from S using Next; other- 
wise EndofIS] is false. 

For some input streams, Endof is difficult to implement sen- 
sibly. In such cases Endof always returns false and Next yields 
the value ENDOF STREAMCH, when no more ordinary items can be ob- 
tained. 

PutBack. 

PutBa ck CS,x3 returns the item x to stream S so that a subsequent 
call of Next will produce exactly x. Several items, which need 
not even have come from S, may be put back; they will be 
reproduced in a last- i n-f i rs t-out fashion. See also -C4>. 

For output streams: 

Out. 

OutCS,xH results in the item x being output along stream S. 

For both input and output streams: 

Reset. 

ResetCSl results in stream S being restored to an initial state, 
which depends on the particular stream in question. 

Close. 

CloseCSD does any sort of terminating action, and relinquishes 
any storage associated with S. No other primitive may be applied 
to S after Close. 

The items which are transported along a stream are typically 
characters (bytes) or words. But it is possible to build streams 
which yield or accept any sort of data structure, e.g. vectors or 
st ri ngs . 

The system contains a number of standard streams, and some stan- 

7.1 
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dard stream functions which produce new streams, using either an 
argument which may be an existing stream or file, or system infor- 
mation; the Latter case includes stream functions for non-standard 
devi ces . 

Streams may be classified into lowest level streams - those which 
communicate directly with the i/o-nucleus, and higher level 
streams - those which are built on top of lower level streams. A 
similar distinction applies to stream functions, since it applies 
to the streams they create, 

A commented list of system streams and stream functions follows. 
The first six streams, Keyboard, Ptr, Ptp, Console, Printer, and 
LineBuffer are always available; they cannot be closed. Other 
streams must be created by the user program and should be closed 
when they are no longer needed. 

7.2. Lowest Level Streams. 

Keyboard . 

The basic character input stream from the console keyboard. En- 

dof is always fal.se. Keyboard is unique among input streams in 

that PutBack is not allowed. Keyboard is intimately connected 

with the trap me ch ani sm-C5 .1 > . Characters spontaneously typed by 

the operator are stored in a circular buffer from which Next 

removes them. 

Reset discards any buffer contents. 

Striking CTRL R displays the buffer contents on console. 

The basic byte stream from the RC2000 paper tape reader. Ptr 

uses a double buffer arrangement, as do Ptp and Printer. Endof 

always returns false , and ENDOFSTREAMCH are returned by Next 

when a tape has run out. Reset discards any buffer contents. 



Ptg. 

The basic byte stream to the paper 
buffer contents. 



tape punch. Reset outputs 



£■2." tliSllllsr. Level Streams. 

The following two streams, Console and Printer, use nameless 
lowest level streams, which are invisible to the user. For all 
practical purposes they may be considered lowest level streams. 



Console. 

The basic character output stream for the console. It converts 
the internal ASCII character set-C13> to console representation, 
and outputs one character at a time. Reset empties the Console 
buf fe r . 
Striking CTRL S stops the Console output, until CTRL Q is 

7 .3 
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st ri ked. 

CTRL inhibits Console output, until another CTRL is striked. 

Printer. 

The basic character stream to the printer. It converts internal 
ASCII -C13> to D200 line printer representation, and empties its 
buffers, not only when they are full, but also when a line feed 
is output, in order to speed up printing. Reset outputs buffer 
contents. 

LineBuf fe£. 

This is the commonly used stream for character input from the 
keyboard. It allows the operator to type and edit a whole line 
before its contents are taken seriously. By using Keyboard, 
LineBuffer reads characters up to a car return and treats them 
as follows: 

1. ordinary characters (none of the following) are inserted in a 

rubout causes the last character read to be deleted from the 



2. 



buffer . 

rubout causes the last character read to be deleted from 
buffer and echoed to the console. 
3. backspace causes the last character to be deleted from 
buffer and from the line image on the console. 



the 



4. 
5. 



butter .and trom the Line image on the console, 
cancel, CTRL X cause the buffer to be discarded 
return to be output on the console, 
car return marks; end nf I inl- 



and 



car return marks end of line 



The result of the call of Next, which caused the buffer filling, 
will be the first character in the buffer. Subsequent calls of 
Next will return the remaining characters in the buffer, until 
it is empty. Then Next will start a new buffer filling etc. 

Reset for LineBuffer discards the buffer and resets Keyboard. 
Endof is always false. 

Z-ii" Functions Yielding File Streams. 

These functions may also be considered I owest- leve I . They all take 
a file-description (fd) -C9> as an argument, and return a stream to 
read or write to the file. 

InFrom fik^^ ^^ yields a word stream to read file fd sequentially. 
Reset on such a stream causes reading to continue from the begin- 
ni ng of the file. 

§y.£§§. from Fi I eCf d3 is similar to InFromFile, but it creates a byte 
stream, i.e. two subsequent calls of Next yield the two bytes of 
each word of the file. For compatibility Endof works the same way 
as for Ptr. 

OutToF ileLf dD returns a word output stream to write to file fd. 
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In order that the file description and the internal housekeeping 
information of the file body may be updated, it is critically im- 
portant that the streams created by OutToFile or one of the three 
functions, which follow, are closed, when writing is complete. 

In order to save at least some of the file output from disastrous- 
ly failing programs, a Fail-Close routine for a file output stream 
C83, is inserted in the C learllpChai n-C4.1 >, and this Fail-Close 
routine will close it at the point where the last Reset took 
place. 

The function of Reset is to save enough information about the file 
for Fail-Close to do this job properly. However, if neither Reset 
nor Close is ever called, the file description will not be changed 
at all, and for all practical purposes the stream might as well 
not have existed. 

B^tesTgF i leCf d] returns a byte output stream to write to file f. 
Files written using streams produced by BytesToFile may be read 
using streams produced by By tes F romFi le . 

OutToFile and BytesToFile create streams which overwrite a file; 
if, instead, it is desired to add information to an existing file, 
similar streams are produced by: 

AddToFileCfdH, and 
AddB^tesfoFileCfd: . 

All these functions are combined to 2 parameter i sed functions, 
which can be used when reading and writing files in connection 
with directories -C10.1.1> : ReadNamedFile and WriteNamedFile. 



Z.-5- Hiatal k§vel Stream Fynctions.- 

WSC^s FromBSCSH yields a stream that reads words composed of two 
bytes from stream S. Initially and after Reset this stream will 
skip zero bytes (blank tape); Reset also resets S. Endof works for 
streams constructed by WordsFromBS, but it is inefficient. 

WprdsToBSCSD takes a byte output stream as a parameter and yields 
a word output stream, i.e. each word output to this stream will 
become two bytes to be consumed by the argument stream. Reset 
resets the argument stream. Close also closes the argument stream. 

*D££°deFromRaw CS] takes a byte input stream as a parameter and 
returns a stream of internal ASCII chara cte rs-C1 3>. It works as a 
filter for streams containing "strange" characters. Reset resets 
the argument stream, which is also closed by Close. 
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7-6. Buffered St re a ms. 

The Next and Out primitive routines usually work by invoking a 
further stream-dependent routine, but for efficiency some streams 
use buffer arrangements. For these streams, the primitive Next and 
Out routines merely consume/insert an item from/in the buffer, and 
only when the buffer is empty/full, a further stream-dependent 
routine, the HandleBuffer routine, is called. 

In order to speed up block-transfers on buffered streams, which in 
BCPL would be written as 

$( for i=0 to n-1 do v ! i : = Next CIS ] $) 
$( for i=0 to n-1 do 0utC0S,v!i: $) 

two functions NextB lock CIS, v, n3 and OutB lock COS, v, n3 have been 
written . 

IS, OS are the input/output stream, v is the address of the block 
containing the elements in v!0 through v!(n-1). 

The result of NextBlock is DONE if the stream could deliver n 
elements, otherwise the result is the number of elements missing. 
The result of OutBlock is always DONE. 

The routines are implemented by a micro-programmed copying between 
the stream-buffer and v, including calls of HandleBuffer, so when 
used on non-buffered streams nothing is gained in speed, since 
this is similar to the for-loops above. 

NOTE: NextBlock and OutBlock works only for byte- and word- 
streams, but can of course be used as Next/Out functions for a 
b lock-stream . 



I-I- Stream Vectors. 

This subsection is intended mostly for the programmer who wishes 
to write his own stream functions. 

Streams are implemented by means of stream vectors, whose entries 
•contain the routines and other items of information which are 
necessary for the stream primitives to work. 
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The general format of a stream vector is as shown: 

A stream vect or 



0: 


• 


TYPE 


1 : 


AUX/IOBUFFER/CHCOUNT 


2: 


* 


CLOSE 


3: 


• 


RESET 


4: 


• 


STR/EXECBLOCK/FD 


5: 


* 


OUT/BUFPTR 


6: 


* 


NEXT/BUFEND 


7: 


* 


HANDLEBUFFER 


8: 


* 


ENDOF/OFPAGE 


9: 


* 


PBSTORE/NEWBODY 


10: 


used by file-streams 


11 : 


-"- 


12: 


CLEARUPCHAIN 


13: 


FAILCLOSE 



fig- 7.1 



It is possible to use stream vectors with more entries than shown, 
in fact only those entries marked * are used by the primitive 
functions. The entries Close, Reset, Out, Next, Endof must hold 
the routines, which implement the respective primitives for the 
stream in question. Where a primitive is not applicable, the 
global routine StreamError should be used. 

The STR entry is ordinarily used to hold the value of a lower 
level stream on top of which the stream in question is built. 

PBStore is used by PutBack, and the AUX entry has no standard i n- 
terpretati on. 

HandleBuffer only has meaning for buffered streams, it contains 
the HandleBuffer routine. For buffered streams, Next/Out routines 
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are unnecessary, and their Locations are used for buffer pointers. 

In order to cooperate with the primitive Next, an input HandleBuf- 
fer routine should, after filling the buffer, adjust the pointers 
so that the BUFPTR entry points to the first item in the buffer, 
and the BUFEND entry points just after the last one, which does 
not necessarily have to be at the physical end of the buffer. 
Similarly, an output HandleBuffer routine, after outputting the 
buffer contents, should set the BUFPTR entry to point to the first 
word of the buffer, and the BUFEND entry to point just beyond the 
last word of the buffer. Notice that the pointers are absolute, 
not relative to the buffer. 

The Reset routine for a buffered output stream may perform any 
desired action and should then set the buffer pointers exactly as 
described for HandleBuffer to enable a new buffer filling. For 
buffered input streams, Reset may sensibly set the two buffer 
pointers to be equal, thereby causing a subsequent call of Next to 
provoke a call of the buffer filling routine. 

The TYPE entry of a stream vector contains the stream type, a word 
in which the bits are interpreted as follows. 

Bit Meani ng 

input stream 

1 output stream 

2 buffered stream 

4 by t e st ream 

5 word stream 

1 PutBack al lowed 

11 lowest level stream 

Only those bits which are relevant should be set in a stream type 
word. When resetting a buffered stream, also reset the type. 

Apart from these bits, the system uses 4 more when operating on a 
stream: 

Bit Meani ng 

7. byte-stream: indicates left/rigth byte next 

8 PB1MASK 

9 PB2MASK, both used for PutBack 

13 CTRL off/on: output mode for control characters 
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£"§■ E2CQ!itted iQjDUt / out gut . 

Upon the Next/Out functions, there is build a set of input/output 
routines to help readi ng/ wr i t i ng integer, strings and characters. 
The parameters IS and OS are input- and output-streams respec- 
t i vi Ly : 



Input : 
NextChClSD 

Neat nc is: 

NextSClS] 

ReadNCIl 

ReadSC: 



skips bytes that are all zeroes or all ones, and 
return the first byte which is neither, possibly 
ENDOFSTREAMCH. 

reads a possibly signed integer from IS. any 
characters before the integer, but none after. 

reads a string up to a string-delimiter: 
'*n ' , '*s' , ■ , ' or i . 1 . The delimiter is skipped. 

equivalent to Next NCLineBuf fe rl and skip the 
de I i mi t er . 

equivalent to Next S CLi neBuf f er3 . 



Output : 

QutF COS, FORMAT, p1 ,p2, p12 3 : 

FORMAT is a BCPL-string, which is written character by 
character, until the escape character '%' is found. If 
the character following '%' is one of the f ol lowi ng, the 
next parameter is written out as: 

XX : % 

%S : a BCPL-string 

% C : a character 

%N : a decimal number, written in minimum width 

%Dd : a decimal number, written in d places with 

zero f i 1 1 
%Id : a decimal integer, right justified in d 

p laces 
%U : an unsigned integer in 6 places 
%0d : an octal number in d places with zero fill. 

Example: p1="Jens", p2='P', p3="Hansen", p4=23 

Out FCConsole,"*"%S %C. %S, age: %N*"", p1 , p2, p3, p4H' 
will out put as 

"Jens P. Hansen, age: 23" 



0utDC0S,n,d3 



write n on OS as signed decimal in d places. 
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Qu£NC0S,nD : write n on OS as signed decimal in minimum width. 

Qut0C0S,nI] : equivalent to Out Oct COS, n,63 . 

QutQc.t COS, n,d] : write n as octal number on OS in d places. 

0utSC0S,s] : write the BCPL-string s on stream OS. 
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8. Command interpreter. 



Commands are given to the system by typing them on the console, 
when the system is ready, i.e displays ".." - 

Commands can be divided into 2 parts: 

1. commands executed by routines permanently in core, and 
thereby independent of the file-system. 

2- commands executed by loading and running a system-program. 

In this chapter we will only deal with type-1 commands, the type-2 
commands will be described in chapter -C1 1 >.. 

When a command is typed, it is first looked for as a type-1 com- 
mand, and if not found, control is given to the file-system com- 
mand-interpreter, which will interpret the command as the name of 
a file to load and execute {10.2>. 

For each type-1 command we now give its name, an indication of the 
kind(s) of its par ameter ( s) , if any, its context-C5 -2>, and a brief 
descr i pti on. 

Parameter kinds are given by n for integer, fn for filename, and 
sw for a swi t ch( on/of f) . Some commands may only be used, when the 
system is not trapped, they have context NT, others are only ac- 
cepted in a trap situation, this is indicated by T. NR means no 
rest ri ct i on. 

Commands for loading and running Er.ocjrams, and some special 
facilities: 

load fn NT unloads all code, except system, and loads file 
fn.REL. 
fn=ptr loads from RC2000. 



addload fn NT loads binary code from fn.REL in addition to code 
already loaded ( for seperatly compiled segments). 

equivalent to RunCStartU, where Start is global 1. 

sets stackbase register P0 = n-C2> 

set store location I to value n 

controls load- map option: 
n=0 : no load map 
n=1 : a simple map of code and data segments 

loaded are displayed on the console. 
n=2 : a full map, incl. routine entrypoints, 

is given on the printer. 



go 




NR 


setPO 


n 


NT 


set I 


n 


NR 


map n 




NR 
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DS sw NT turns the File-system on or off. The command 

"DS on" is executed automatically as part of the 
normal deadstart procedure-CI 4>. 

£pmii!3Dds for interaction with running Programs: 

trace sw NR controls trace f a c i I i t y-C6 -1 > 

dump n1,n2 NR contents of memory location n1 through n2 are 
displayed as unsigned decimal, signed decimal, 
decimal by halfwords, octal and as characters. 



cont 
stack 

cb 

end 

reset 



T resume trapped prog ram-C5 .1 > 

T display the stack of the current (trapped) run on 
the console.. 

T display contents of context-block (registers). 



NR equivalent to fjrnsh 

NR exits from all runs, unloads all code except the 
system, resets all globals to their values at 
system setup. The exit from Runs is a disorderly 
one, in particilar C learUgChains are not obeyed, 
reset is intended to be used as a last resort to 
save the system, when important global values have 
been corrupted. 

Apart from these commands, which can be used by all users, there 
exists a set of file- and directory managing commands, which nor- 
mally only are used when bootstrapping the file-system. 
They are only availble to the Master-user in a non-trapped con- 
text, and they have equivalent use r- commands as described in sec- 
tion CM .2>: 

Dir name NT walk one-step up or down the directory tree 

Newdir name NT create a new directory 'name' 

Type fn.ext NT type the file on console 

Print fn.ext NT print the file 

Punch fn.ext NT punch the file 

Delete fn.ext NT delete the file 

Files NT give a list of files in the directory 

Readptr fn.ext NT readin a file from RC2000, and name it fn.ext 

Rename f1.e1,f2.e2 NT rename f1 .e1 to f2.e2 
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2- Jhe RIKKE file system. 



This chapter is intended to serve as an users guide to the file- 
system. A comprehensive description of the design and implemen- 
tation of the file-system can be found in C 83 . 



2-1" Direct ories. 

The only way the system-routines can access a file is by a 
f i ledes cri pt i on (fd), a block of words, which contains a sort of a 
pointer into a MasterFile on the physical disc, where the file is 
stored. 

A directory is a list of entries, each consisting of a filename 
and a fd, so the purpose of directories is to enable the users to 
reference the files by names, instead of by fd's. 

A filename on RIKKE consists of a name and an ex tensi on<9.3> . All 
filenames in a directory must be unique. 

A special sort of entries in a directory is a directory itself, so 
the directories form a tree-structure. This eliminates the use of 
long and complicated filenames, as the number of directories and 
levels in the directory-tree are (almost) unlimited. 
The files, whose entries are in a directory, are said to be or 
exist in that directory. 

A directory has one more purpose, than being a collection of 
files. It can also be regarded as a possible environment for the 
user. At any time the user is in such an environment (directory), 
called Cur rent Di rectory, and will view the directory- and file- 
structure as seen from Cur rent D i rectory . 

In the following figures we use rectangles for directories and 
ci re les for f i les : 
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Di rectory-structure: 
Master Directory 








disk 
1 




disk 
2 




y 














user 
a 




user 
b 




Droj. 
c 





Login- \ 
Directory \ 




fig. 9.1 . 

Cur rent Di rect ory pLays a special role, when typing a name to the 
command-i nte rpret er-C1 .2> . 

At any time the user can "walk" up and down the directory-tree, 
i.e changing environment, by using the command ' d i r * -C1 1 .2 .9> . 

The overall root of the directory-tree is called Master Di rectory. 

2-1" y§iD9 dir§£l2ni§§ ■ 

To enter the system, a user must have a username and a password, 
assigned by the "Master-User". Each user-name is assigned a 
Log inD i re ctory, the users Cur rent Di re ct ory after Login. 

From this directory the user can create a new directory-structure 
with LoginDi rectory as root, and move freely around this struc- 
ture, only limited by Log i nDi rect ory at the top. It is never pos- 
sible to go beyound the LoginDi rectory. 

CurrentDirectory also serves as a default look up- directory, when 
accessing files, but it is always possible to access files in 
other directories, provided they are not protected. 
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2-2- N3Q11D9 2f IlLSS- 

A file name in a directory consists of two parts, the name and an 
extension- Both name and extension can in principle be arbitrary 
ASCII-strings, but because the system routines interpret the 
characters ' * s ■ , ' * n ' , ' , ' and ' . ' as string-delimiters, it is 
recommended to restrict the names to alphanumeric strings- 
Note: small and capital letters are different characters. 

The name is normally used to identify the file, whereas the exten- 
sion is intended to tell something about the type of a file. 

Default extensions are: 

BCPL - a BCPL source file. 
BAK - a back-up file made by the editor. 
REL - a relocatable binary OCODE file'. 
SMB - a symbolic OCODE file. 

These extensions are maintained by the system as in the following 
example : 



A-BCPL exist in Cur rent Di rect ory 

After editing the new version is still called A. BCPL, and 

A-BAK is the old version. 

The compiler compiles A-BCPL either into symbolic OCODE on 

A. SMB, or to relocatable binary OCODE on A. REL. 

The assembler assembles A. SMB into A. REL. 

Typing A on the console, the file A. REL will be loaded and 

executed-C1 -2>. 



From the systems point of view directories are also files, and 
therefore subject to the same naming conventions. They have the 
special extension DIR, and it is adviced to keep this extension 
for directories only, and not use it for ordinary files. 

To protect files against misuse from any of the users the system 
provides a protection mechanism. 

Allthough the users are personally identified by Login, the system 
uses the directory-structure to divide users into protection 
groups. 

Therefore the access rigths doesn't depend on who the user per- 
sonally is, but only in which directory he is ( C ur rent Di rect ory ) , 
so in the rest of this chapter, a user always means a directory, 
which of course normally can be identified with the person using 
that di rectory. 

When a file is created, it is brought into the directory-structure 
as a son of the present Current Di rect ory . This directory will now 
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be regarded as the owner of that file, and will have all rights to 
the file. All other directories will be called users of that file, 
and they get the rights as decided by the owner. 

Allthough directories also are created as sons of other direc- 
tories, directories are users themselves, and therefore they can 
be made their own owners£81. 

Therefore: The owner of a directory is the directory itself, the 
owner of any other file is the father of that file. 

This user/ owner division of users could be used to divide them in- 
to protection groups, but because the directory structure is 
static and hierarchical, it can be used to subdivide further. 

In relation to each file the users are divided into five groups: 

= the owner 

1 = the ancestors of the owner 

2 = the descendants of the owner 

3 = those descendants of the owner's father, which are not in 

g roup or 2 . 

4 = all other directories. 



Examp le : 



Master Directory 




\ © 



Protection groups in relation to file A 



fig. 9.2. 
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Group 3 may not seem so relevant as the others. Its purpose is to 
provide the possibility to give files, common to a project group, 
a special access-rigth for the members of the project. 

Thus the protection groups are from the system's point of view 
pairwise disjoint. But it will be normal to regard the protection 
groups hierarchical by giving group at least the same rights as 
group 1, group 1 at least the same rights as group 2 and so on 

Each of these groups is given an access-right. 

There are 8 categories of ac ce ss- r i ght s : 

0=CHANGE PROTECTION ACCESS: 

The right to change, protection of the file. (The owner has 
always the right to change protection, regardless of his ac- 
cess ri ghts) . 

1=DELETE ACCESS: 

The right to delete the physical file on the disc. This ac- 

cess-right does not imply the right to delete the entry in the 
di rectory . 

2=WRITE ACCESS: 

The right to change the contents of the file. The user can 
thus empty the file completely, but there remains an empty 
file. For directories this access right is equivalent to the 
right to remove entries . 

3=UPDATE ACCESS: 

This has only meaning for directories, where this access right 
will give the right to rename all files in that directory. 



4=APPEND ACCESS: 

The right to append information to the end of the file, 
directories this is the right to insert new entries into 
di rect ory . 



For 
the 



5=C0PY ACCESS: 

The right to copy the file to another file via the system- 
programs. Is not valid for directories, as these must not be 
copied. 

6=READ ACCESS: 

The right to read a file, but not to modify any of the con- 
tents of that file. For directories this is the right to look 
up in the directory. 

7=N0 ACCESS: 

No rights to the file at all, except that the user may know 
the existence of the file, if he has READ-ACCESS to the father 
of the file. 
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Th e access rights are hierarchical, e.g. a user having access 
right 4, also has access rights 5 and 6 too. 

There is one special case of protection: The owner-entry of a file 
cannot be deleted, without deleting the file too. This is to as- 
sure, that each file always has an owner. 

As each protection group is assigned an access right, the protec- 
tion key for a file is a 5 digit number. 

For example default protection for a file is 00557, which means 

group : all rights to the file. 

group 1 : all rights to the file. 

group 2 : the right to copy and read the file. 

group 3 : the right to copy and read the file. 

group 4 : no rights at all to that file. 

When a user want to access a file, the system finds out which 
protection group he ( Cur rent D i r e ct ory ) belongs to. It will then 
look up the access right for this protection group. If the access 
is done in accordance to this access right, the access will be 
granted, otherwise an error will be the result. 

The default protection for directories is 224 46. 

2-5- Link and cogy. 

If a user frequently want to access files in other directories, it 
can be more convenient to make an entry for those files in "his 
own" directory too. This can be done in 2 ways: 

1. Make a cogy of the file. This copy is the users your own file, 
and he is the one to decide anything about the file. If the 
original file is updated, that update will be missed. 

2. Make a l±nk to the file. Only an entry for the file is inser- 
ted in the directory, the file is still the property of the 
original owner, and the user can only handle the file ac- 
cording to the ac cess-r i gt hs . The owner can delete the file 
any time he wants, but the users are sure always to have a 
link to the most recent version of the file. 
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Li nk or Copy 
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fig- 9-3 - 

In this sense directories are not files, and they can 
copied nor linked. 



nei t her be 



2-6. Discs and directories- 

The RIKKE disc-system consists of 2 DI ABLO-dr i ve s, each consisting 
of 1 fixed disc and 1 exchangeable disc, giving a configuration af 
2 fixed discs, and an unlimited number of exchangable discs- 
Each disc consists of 408 tracks of 24 sectors of 260 bit words, 
256 data-words and 4 for system- i nformati on- This gives a total 
data-area of 97 92 pages (blocks) of 2 56 words on each disc. 

The files in the file-system can be stored on arbitrary discs, of 
which up to 4 can be mounted simultaneously. These 4 discs could 
be identified to the system by their physical location 0-3, which 
is called the disc-unit. 
The disc mounted on disc-unit i is called physical disc no. i. 

Because of the unlimited number of discs, that can be mounted, 
each disc has to be identified by its logical disc.no, also called 
the logical device no-, to the system. Each disc is therefore 
given a logical device name and number, and we then have logical 
disc no j equal physical disc no i for 0<=i<=3 and 
0<=j<=MAXDEV(20) - 

The files on each disc are hierarchically ordered, and the root is 
called the D i s cDi rect ory . When a disc is mounted, the Disc- 
Directory on that disc will become a son of the Mast erD i rect ory, 
and it will get the name " logdev" -DIR in MasterDi rectory, where 
logdev is the logical device name for the disc- 
Thus mount means two things. One is to physically place a disc on 
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the disc-drive, and the other is to connect the directory struc- 
ture on that disc with the MasterDirectory (and the rest of the 
f i le system) . 

Using the Latter meaning, all discs (incL. physical discs and 2) 
can-be mounted and dismounted. 

The normal disc configuration after deadstart will be 

logical disc no = physical disc no = disc "SysAdmin" 
logical disc no 1 = physical disc no 2 = di sc ' "User Diskl " 

and the other two discs are to the disposal of the users. 

In case of any doubt about where Cur rent Di rect ory is situated in 
the directory-structure, the command "ident" -C11.2.18> can be used 
to list the path from Mas terDi rect ory to Cur rent Di rect ory on the 
console . 



2-Z- A further note on files. 

The first description of files was somewhat simplified, and maybe 
a little misleading. We will now explain some important concepts 
in the file-system, but for details, the reader is still referred 
to C8D. 

On each disc is a Master File, which contains a heading for each 
file. This heading holds information such as the address of the 
first and last page of the file, protection information, and 
creation- and update-time. Furthermore it contains for each file 
an identifier (UID), which is guaranteed to be unique among all 
files ever created in the system. This UID is used for control 
purposes. 

The index of the heading in the MasterFile is called the file 
value (fv) of that file. 

To identify a file on the disc, the logical disc no. and the fv 
for the file must be known. Then the heading can be found in the 
MasterFile, and from there the file itself. To be sure to access 
the right file, the UID must also be supplied. This is checked 
against the UID in the heading, and only if those two UID's are 
identical., the file can be accessed. 

This set (logical disc no,fv,UID) together with some protection 
information is called the file description (fd), and this is 
precisely what is neccessary to access a file. 

The normal way to find -the fd for a file, is looking up in a 
directory for a name assigned to that file. The real contents of a 
directory is therefore a set of tuples (name, ext , f d) . 
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1Q- y§iD9 £h£ like system. 



The user will normally be interested in using the file system at 

two levels, of which the upper level is the command interpreter 

mode, and the lower level is the user mode, i.e executing user- 
programs. 

1Q-1- y§er mode. 

The sy st em- li bra ry contains routines available to all users to 
lookup a file, access a file for reading or writing. 

The users are advised only to access files through streams, 
created by these library routines, as this is the only file-access 
supported by the system. 

1Q-1-1" Evading/ writing iites by name. 

The normal way for users to read/write files is to identify them 
to the system by their names in CurrentDi re ct ory : 

E§adNamedF i leCf Q,ext,ty gell : 

Returns an input-streams S to read the file, identified by 

fn.ext in Cur rentDi re ct ory . The value of type must be BYTES or 
WORDS, giving a byte- or word-stream. 

If the file is not found, or if the entry in the directory con- 
tains a wrong UID, a message is displayed by G iveUp<5.1 > . 
After reading the file it should be closed by CloseCSD. 

WriteNamedFileCf n,ext,tyge,modeIl : 

Return an output-stream S to write the file, identified by 
fn.ext in Cur rentD i re ct ory . The value of type must be BYTES or 
WORDS, giving a byte- or word-stream. 
If a wrong UID entry is found, the routine calls GiveUp. 

The precise action of the routine depends of the value of mode: 

OVWCR: if the file exists overwrite it, else create the file. 

ADDCR: if the file exists append to it, else create the file. 

OVWGU: if the file exists overwrite it, else GiveUp. 

ADDGU: if the file exists append to it, else GiveUp. 

CREGU: if the file exists GiveUp, else create it. 



For a discussion of Reset 
reader is referred to -C7.4>. 



and Close to output-streams, the 



10.1 .1 



-32- 



1Q-1-2- Read ing/ writ ing flies b^ fd. 

As the reader may have guessed, the names Cur rent Di rect ory, 
Mas t erD i re ct ory, Log i nD i re ct ory and Sy s t emD i re ct ory actually holds 
fd's, pointing to the directories. So in the following when we 
write 'dir', we mean an fd pointing to a directory. 

L22kyi2£ilE£Q'ex t ,cHr3 : 

Returns a fd for the file identified by fn.ext in directory dir 
(e.g Current Di rect ory) if it is found, otherwise the value 
NOTINDIRECTORY is returned. 

ReturnFDCf d) : 

returns the fd-block to the f ree-st ore-C2 .1 >. 

The fd found by LookUpDir can now be used as argument to the func- 
tions in section -C7 .4> to create input- or output-streams S. 

Whenever a stream is created this way, the possibility of 
violating the ac cess-ri g t hs or accessing a wrong-UID file, exist, 
so before using the stream S , the routine 

CheckNamedFil eCf n, ext, S,msg3 should be called, which in any of the 
two cases displays an • error-message and gives-up. 

The ( system-) programmer, who wants to go beneath this level for 

accessing files, are referred to C8] 

1Q-2- Command-interpreter mode. 

In the command interpreter mode the system will accept commands 
from the users, which will then be interpreted and executed if 
possi b le. 

When the system is ready to accept a command it will write two 
periods on the console. 

When a command "com" is typed, the command- i nte rpreter will do 
the f ol lowing : 

1 Look- up in a set of commands, executed by programs always in 
core. If there is such a command, it will be execut ed-C8>. 

2 Else CurrentDi rect ory is searched for a file called com.REL. 
If there is such a file it will be loaded and executed. 

3 Else a special directory with system programs, System- 
Directory, will be searched for com.REL. If there is such a 
file, it will be loaded and executed. 

A Else the system gives up with the message "File com.REL 1 does 
not exist". 

The way to pass parameters to user-programs is described in C1 1 . 

The exact format of the commands supplied by the system is given 
in -C11 .1>. 
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11. Commands. 



This section describes all the system-programs, the users can 
call, via the command-interpreter. 

We start by giving some general rules for the format of commands, 
and then we describe each of the commands in detail. 



11-1- ESQffiii 2f £2(Q!S§D^S- 

The format of a command is 

com p1 p2 p3 ... pn 

where 

com is the name of the command. 

p1...pn are the parameters for the command. 

com and p1 , as well as each pair of parameters, are separated by 

The parameter list is terminated by carriage return. 

The parameters are often file names or directory names. There are 
some special rules for these. 

If the parameter is a file name or an extension, it can normally 
be written with "wild characters", where 



II n I 



'*" means any string with length >=0 
?" means any character 



Thus for example 

"*" matches any name 

"?a*" matches all names with "a" as second character. 

"abc" matches only the name "abc" 

The directory given will then be searched for all files, where 
both name and extension match those patterns specified in the 
parameters, and the command will be executed for all such files. 

If the parameter is a directory, the directory must be specified 
by writing the directory path. 

This is specified with the following syntax: 
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sy nt ax for di rpa th 
di rpa th 



-> ' : ■ ( Cur rent Di rectory) 

-> startdir <dir-id>* enddir 



startdir -> '>■ 
-> •) » 

-> {•<•}+ 

-> empty 
di r-i d -> di rname '>■ 
enddi r -> di r-i d 

-> di rname 
di rname -> any bcpL-string 



start-search 
Mas t er Di rectory 
Logi nDi rect ory 
An Ancestor 
CurrentDirectory 



Directory-path example 



QJ 







FlasterDirectory 





D | LoginDirectory 

P CurrentDirectory 

G 



fig. 11 .1 . 



fig. 11.1 from Current- 



To reach each of the directories 
Directory the users must type: 
(the number in brackets shows which protection group Current- 
Directory will be assumed to belong to) 



(2) 



A: 


> 


(4) 


or 


<<< 


(2) 


B: 


>B 


(4) 


or 


<< 


(2) 


C: 


>B>C 


(4) 


or 


«C 


(3) 


D: 


>B>D 


(4) 


or 


) 


(4) 


E: 


<E 


(3) 


or 


)E 


(4) 


F: 


; 


(0) 








G: 


G 


(1) 








H: 


G>H 


(1) 








I: 


>B>OI 


(4) 


or 


«OI 


(4) 
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Before Login, the only commands, that can be executed, are 
DS on 
DS off 
mount 
di smount 
help 
L ogi n 

The explanation of the commands and their formats, as given in 
next section, are also available at RIKKE. The user can at any 
time issue the command "help" to get the wanted information writ- 
ten on the console. 

In the following commands the symbols "-C" and ">" mean that the 
parameters between the brackets are optional, and a "*" after a 
pair of brackets means that these parameters can be repeated zero 
or more times. 
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11.2- List of Commands- 



11-2-1- aggend. 
format : 
action: 



defaults: 



append fn.ext dir -Cfn-n.ext-n dir-n>* 

If fn.ext is in dir, all files matching the 
fn-n.ext-n's in dir-n's are appended to file fn.ext. 
If fn.ext is not in di rectory ■ di r, it is created 
before the other file(s) are appended to it. 

If the last directory is omitted, Cur rent Di rectory 
is assumed. 



restrictions: fn.ext in dir cannot be appended to itself. 
Directories cannot be appended, 
fn, ext must be simple names (no *'s or ?'s) 

protection: APPEND-ac cess is necessary to fn.ext in dir. 

If fn.ext has to be created, APPEND-ac ce ss is neces- 
sary to dir. 
COPY-access is necessary to the f n-n. ext-n 1 s . 



11-2-2- assdr- 

format: assdr fn-1 -Cf n-2 - - - - f n-n> . 



action: 



protect i on : 



All action is performed in CurrentDi rectory. 

One or more symbolic OCODE-files are assembled 

together on the file named ocode.REL, the program 

will ask for the name 'ocode 1 . 

If the file ocode.REL does not exist, it will be 

created, else overwritten. 

The files to assemble must have extension .SMB, 

generated by option n/ N in the BCPL-compi I er C1 1 . 

If -Cf n-2 . . . f n-n> are omitted, fn-1 can be a 

'wild'-name, else all fn's must be simple names. 

READ-access is neccessary to the .SMB files. 
If the file ocode.REL already exist, WRITE-access is 
necessary, else APPEND-access is necessasy to 
CurrentDi rectory. 
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H-2.3. bcgl. 
format : 
a ct ion : 



bcpL fn-1 -Cf n-2 . . . . f n-n>. 



must be in Current- 



x,X 



d,D 



The files to be compiled 
Di rect ory . 

The action depends on the options given when promp- 
ted: 

if option n/ N is specified, each file is compiled 
into symbolic (not readable) OCODE on a file named 
fn-i.SMB, else each file is compiled into a 
relocatable binary file named fn-i.REL. 
Opt ions : 

t,T : generate trace information. 

system words are in CAPITAL- letters, 
repeat-option, each file can consist of one 
or more segments, seperated by * .*, and they 
are compiled into one file named fn.REL or 
fn.SMB. 

If the compiler error "TOO MANY NAMES 
DECLARED" occur, you may increase the size 
of the internal name-tabel by specifying 
e.g. d 2500. 

For further options see C1 1 . 

If -Cf n-2 . . . f n-n> are omitted, fn-1 can be a 
•wild'-name, otherwise all fn-i's must be simple 
names . 

defaults: Default options: d 2000. 

Generate .REL file without trace information. 
If a get- file isn't found in CurrentDi rectory, the 
compiler will look for it in the system-get direc- 
tory, named >SysUser>Heade r • 

restrictions: The files to be compiled must have extension .BCPL 

protection: READ-access is necessary to all .BCPL and .GET files 
used. 

WRITE-access is necessary to . SMB and .REL files, if 
they exi sts . 

If a new file is created, APPEND-ac cess to Current- 
Directory is neccessary. 
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11-2-4- combine. 



format : 
a ct ion : 



prote ct ion : 



combine ToFile file-1 fiLe-2 



fiLe-j 



The file ToFile. REL may contain several segments of 
relocatable binary code, or it may not exist. 
Each segment is identified by the '$ident "iden- 
tifier" 1 construction in the sou rce-text C1 1 The com- 
mand will substitute those segments on ToFile. REL, 
which are present in the files file-1. REL 
file-j.REL, with these latter versions, 
example : 



file-1 

f1 
f 3 . 



f i le-j : ToFi le.REL: 



REL 
REL 



f1 , 
f2. 
f3, 
f4. 



REL 
REL 
REL 
REL 



The segments fl.REL and f3.REL on ToFile. REL are ex- 
changed with the new versions. 
If a file-i is not found, it can be appended. 

COPY-access is necessary to file-1 .. file-j. 
WRITE-access is necessary to ToFile. REL. 
If Tofile.REL has to be created, APPEND-ac cess is 
neccessary to Cur rent Di rect ory . 



11-1-5- commands . 

format: commands -Cfn> 

act i on : 



Gives a list of all commands available to the users 
as system-programs in Sy st emDi re ct ory, either on the 
console or on the file fn.COMM. 

protection: WRITE-access is neccessary to fn.COMM, if it exists. 
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11-2-6- cog^- 
f ormat : 
a ct ion : 



defaults : 

rest ri ct ions : 
protection: 



copy fn1 -extl di r1 -Cfn2-C.ext2 <di r2>>> 

fnl.extl in d i r1 will be copied to dir2 and given 
the name fn2.ext2- 

If fn2.ext2 already exists in dir2, you will be 
asked whether to unlink, delete or rename the old 
fn2.ext2 / or give up the copying; if it does not 
exist, it will be created- 

If fn2, ext2 or dir2 is omitted, fn1, extl or 
Cur rent Di rect ory is assumed- 
Directories cannot be copied. 

COPY-access is necessary to fn1 -extl - 
If fn2-ext2 has to be created, APPEND-ac cess is 
necessa ry to di r2 . 

Ac cess-ri gt hs needed to un I i nk,de lete or rename 
fn2,ext2 - please look under the commands un- 
link, delete, or rename. 



H-2-7. count. 

format: count -Cdevice> 

act ion : 



defaults : 



Counts the number of free pages on the specified 
device, e.g "UserDiskl". 

If device is omitted, all mounted devices will be 
counted. 
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11-2-8- delete. 

format: delete fn.ext -Cd i r> 



act i on : 



def au It s : 



fn-ext will be deleted (that is: the physical file 
will be destroyed, and the entry in dir will be 
removed), or unlinked (that is the entry in dir will 
be removed), depending on the protection. 

If dir is omitted, Cur rent Di rect ory is assumed- 



restrictions: Directories can only be deleted, if they are empty. 
A file cannot be unlinked from the OWNER-di rect ory . 

protection: The precise action that will be performed depends 
strongly of whether dir is user or owner of the 
file, and which access-right dir has: 



I dir is owner | dir is user | 
| of fn.ext j of fn.ext j 


| at least | delete | give a war- | 
| DELETE-ac cess | the file | ning before | 
j j Idelete/unlinkj 


| not DELETE- | NOTHING | unlink | 
j access j | the file | 



11-2-9. dir. 
format : 
act ion : 

protection: 



di r pa th 

The directory found by 'path 1 becomes Current- 
Direct ory . 
The syntax for 'path' can be found in -C11.1>. 

'path' must be a directory path, and in that path 
LoginDi rectory must not be exceeded 
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11-2-10- disass. 

format : di sass f n 

action: Makes an OCODE disassembling of the file fn.REL in 
Cur rent Di rect ory on the file fn. DISASS. 

protection: READ-access is neccessary to fn.REL. 

WRITE-access is neccessary to fn. DISASS, if it 
exi sts. 



11-2-H- dismount. 

format: dismount -Cname> 

action: The discpack named 'name 1 is dismounted, i.e. the 
files on this device are removed from the file- 
system . 

restrictions: The device holding the MasterDisk cannot be dismoun- 
ted. 

The device holding Cur rent Di rect ory cannot be 
dismounted. 



11-2-11- do. 
format : 
act ion : 



default : 



do fn p1 / p2 / .... / pn 

The file fn.CMD is taken to be a command file with a 
simple parameter substitution. 

In fn.CMD each occurence of #i is replaced by pi, if 
i< = n. 

Example: 

The file modify.CMD is: 
edit #1 
bcpl #1 
The command 'do modify prog" will edit and compile the 
file prog. BCPL. 

If fn.CMD isn't found in Current D i re ct ory, it will 
be looked for in SystemDi rect ory . 



11 .2.12 



-42- 



11-2 -13 - edit. 

format: edit <fn-C.ext>> 



action: 



def au Lt s : 



The basic function of the editor is described in 
C7H, so for a tutorial description of the editor, 
and a List of commands, see that description. 

The editor can be run in two modes: 

1 . if no parameters are specified, no input-output 

files exists, and they must be specified by com- 
mands li ke : 
'gr^'gf' for input and 'gt'^gw' for output 

2 . the norma I way : 

if the editor is called like 'edit fn.ext 1 , the 

editor will create a file named fn.BAK, which is a 

copy of the file fn.ext, when editing is over, 

and the file fn.ext will be the edited file. 

If the file fn.ext does not exist, it will be 

created and a notice is given. 

When working in mode 2, all the g-commands from 1 

are i I legal . 

If you type 'CTRL C, end' when editing, you will 
return to the command interpreter, and nothing has 
happened to your files, except when an output file 
has been closed by a new ' gw ' . 



default extension for mode 2 is BCPL 

restrictions: the call 'edit fn.BAK 1 is illegal. 

protection: To enter a file into the editor, COPY-access is re- 
qui red . 

When working in mode 2, the old BAK-file will be 
deleted regardless of its protection upon completion 
of editing. 

The output-file for the editor must be APPEND/WRITE 
- permitted, depending of how it is specified: 
APPEND-pe rmi t ted when specified by 'gt', 
WRITE-perm i tted else: in mode 2 and by 'gw'. 
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11-2-14. filcom. 
format : f i L com 



action: The program asks for the 2 files to compare. 

In case of a difference, the next 60 characters of 
each file will be Listed on console. 

protection: at least READ-access is needed to the files to corn- 
pa re . 



11-2-15. filedump.. 

format: filedump fn.ext -Cdi r {from -Ct o >>>{$ I > 



act ion : 



default : 



The file fn.ext in dir will be dumped: 
Each word from word no. "from" to word no. "to" will 
be listed as unsigned decimal, as signed decimal, as 
two decimal bytes, octal, and as two characters. 
If ' $1' is specified, the dump of each file will be 
made on the file fn.FILDMP, otherwise on the con- 
sole . 

if dir is omitted, Cur rent Di rect ory will be assumed. 
If from or to is omitted start-of-f i le or end-of- 
file will be assumed. 



restrictions: directories cannot be dumped 
protecti on : 



at least READ-access is needed to fn.ext. 
WRITE-access is necessary to the file fn.FILDMP if 

it exists. 
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11 .2.16. fi les. 



format : 



files -Cfn-C.ext-Cdir-Csearchdi r>>>Xopt1 >-Copt2>-Copt3>. 

The opt i ons can be : 

$a/$alL/$A/$ALL/$ALL 

$L/$List/$L/$LIST/$List 

$s/$sort/$S/$SORT/$Sort 



action: 



traversed, and for 
matches searchdi r , a 



Makes a List of information on all files, whose 

names matches the pattern fn.ext. 

If searchdir is specified, the directory-subtree, 

which has dir as root, will be 

all directories, whose name 

list will be gi ven t oo. 

If option all is set, the 

information of that file, else 

be given. 

If option list is set, the list will be listed on 

the file "files. LPT" in Cur rent Di rect ory, else it 

will be listed on the console. 

If option sort is set, the files will be sorted al- 

fabetically before listing. 



list will 
a shorte r 



contai n all 
list will 



defaults : 



protect i on : 



If fn, ext, dir or searchdir are omitted, "*", 
CurrentD i rect ory or NONE will be assumed. 
NB! in the last three parameters written, the 
tions will override fn, ext, dir or searchdir. 



op- 



READ-access is necessary to *dir'. 
WRITE-access is necessary to 'files. LPT 1 , 
exists. 



if it 



11-2-17. help.- 

format: help -Citem> <$l> 

action: If 'item 1 is specified, all help- texts for items, 
matching 'item' (wild-characters '*' and '?' al- 
lowed) are listed, else a list of all items, on 
which. help is available, is given. 

The list is given on the console, or i f ' $ I ' is 
specified, on the file 'help. LPT 1 
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11-2-18- ident. 
format: ident 



action: 



the path from Mast erDi re ct ory to Current D i re ctory 
and from Master Di rect ory to Logi nDi rect ory are 
Listed on the console. 



11-2-19. info. 

format: info -Ca L L> -C$L> 



act ion : 



The Latest 'message of the day' is typed. 

If ' a L L ■ is specified all the accumulated messages 

will be typed t oo . 

It "SI 1 is specified the information will be typed 

on the file named 'info. LPT', else on the Console. 



11-2-20. link. 

format: link f n1 .extl di r1 -Cfn2-C.ext2 -Cdir2>>> 

action: A Link will be made in dir2 to fnl.extl in d i r1 , 
giving the entry in dir2 the new name fn2.ext2. 
If fn2.ext2 already is in dir2, you are asked 
whether to unlink, delete, or rename the old 
fn2.ext2, or to give up the linking. 
If fn2.ext2 is not in dir2, it will be created. 

defaults: If fn2, ext2, or d i r2 is omitted, fn1, extl, or 
Cur rent Di rect ory will be assumed. 

restrictions: Directories cannot be linked. 

dirl and dir2 must not be the same directory. 

protection: READ-access is necessary to fnl.extl. 

If fn2.ext2 must be created, APPEND-ac ce ss is neces- 
sary to d i r2 . 

Access- ri ghts needed to un I ink,de lete, or rename - 
please look under the commands unlink, delete, or 
rename . 
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ll-i-21- login, 
format : 
act i on : 



Login use rname, passw ord 

The pair use rname, pa ssword is checked to be a valid 
user, and if so, Current D i re ctory is set to the 
users LoginDi rectory. 

If there is any mail to you, you are advised, see 
•help mai I ' . 



11-2.22. logout- 
format : I ogout 



action: 



The user is logged out, and the command interpreter 

enters a special mode, where the only legal commands 

are: 

log in, help, mount and dismount. 
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11-2-23. mail, 
format : 
action: 



mai L ' command ■ 

The mail-system allows users to send messages to 
each other, i.e. to their directories. 
The following 6 commands are legal: 



accept 
type 
send us 

rej ect 
archive 

empty 



ac cep 
c reat 
all u 
the m 
Maste 
typed 
send 
The 
Login 
noth i 
leave 
f i le 
the 
f i le 
MAIL, 
you, 
you w 
the m 



t m 
e a 
se rs 
ailb 
r Di r 

on 

a 
mess 
Di re 
ng w 
th 
MAIL 
cur r 
MAIL 
ARC 
and 
ant . 
ailb 



ail to Cur rent Di rec 
f i le named MAIL. BOX, 

to send mail to you. 
oxes i n the direct 
ectory to CurrentDi 
Conso le . 

message to the user 
age i s . sent to t 
ct ory i f he has a ma 
ill be done, 
e mai l-sy stem, i.e. 
.BOX. 

ent mai Ibox is appe 
.ARC, and then empt 

contai ns all messa 
it can be deleted at 



tory, e.g. 
and allow 

or i es from 
rectory are 

named 'us 1 . 
hat use rs 
i Ibox, else 

delete the 

nded to the 

i ed. Hence 

ges sent to 

any time 



ox is emptied without archiving. 



When a user log's in, he will be advised whether 
there is any mail to him or his fathers. This mail 
can then be read by 'mail type 1 



comment : 



you have to type 'mail accept' to join the 
system . 



ma i l- 



11-2-24. mouQt. 

format: mount -Cunit -Cname>> 

action: A named device is mounted on a disk-unit, i.e. the 
files on that device are entered into the file- 
system. 
The program will ask for the missing parameters. 

comment: After normal system-setup, the only devices mounted 
are the System-Disk and the UserDiskl. 
The System-Disk is mounted on unit and the 
UserDiskl on unit 2. 
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11-2-25- move. 

format: move fnl.extl dirl -Cdi r2-C . f n2 -Cext2>>> 

action: fnl.extl wilt be copied to dir2 with the new name 

fn2.ext2, and then deleted in dirl. 

If fn2.ext2 is already in dir2, you will be asked 
whether to unlink, delete, or rename the file, or to 
g i ve up mov i ng . 
If fn2.ext2 is not in dir2, it will be created. 

defaults: If dir2, fn2 or ext2 is omitted, Cu rrentD i rectory, 

fn1 or extl is assumed. 

restrictions: Directories cannot be moved. 

diri and di r2 must not be the same directory (then 
move would be meaningless). 
Link-files cannot be moved. 

protection: WRITE-access is necessary to d i r1 and APPEND-ac ce ss 
to dir2, and you must have DELETE-ac ce ss to the 
file, else it cannot be deleted in d i r1 , and nothing 
will happen. 

Access-right needed to un I i nk/ de lete/ rename the old 
fn2.ext2 - please look under the commands un- 
link/delete/rename. 



11-2-26. newdir. 

format: newdir di rname 

action: a new directory cabled di rname will be created as a 
son of CurrentDi rectory. This new directory will 
become the new CurrentDi re ctory . 

restrictions: There must not exist a file (directory) in Current- 
Directory called ' di rname . DIR ' . 
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11-1-27- newuser. 

format: newuser -Cdir> 



act ion : 



defaults : 



A new pair of use rname/ password is accepted as Login 
to di rect ory ' di r ' . 

dir =CurrentDi rectory 



restrictions: dir must identify a directory in the tree, having 
current Log inD i re ct ory as root. 
Usernames must be unique. 



11-1-18- oclist. 

format : oc L i st f n 

action: The symbolic OCODE on file fn.SMB (not readable) in 

CurrentDi rect ory is listed on file fn. OCLIST. 

protection: READ-access is neccessary to fn.SMB. 

WRITE-access is neccessary to fn. OCLIST, if it 
exists. 



11-1-12- ecint. 

format: print -Cfn-C.ext -Cdir>>> -Copl . . . opt3>. 

The options can be: 

$s/$sort/$S/$SORT/$Sort 

$nh 

$ni 

action: The files in dir, whose filenames matches fn.ext, 
will be printed on the linepr inter. 

If the option sort is set, the files will be sorted 
by name before printing. 

If option ni is set, no index of the printed files 
will be g i ven . 
If option nh is set, no header will be printed. 

defaults: If fn, ext, or dir is omitted, "*", BCPL, or 
Cur rent Di rect ory is assumed. 



restrictions: Directories cannot be printed ( use the command 
files ) . 

Files with extension REL cannot be printed. 

protection: READ-access is necessary to fn.ext. 
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11-2-30- grotect. 

format: protect fn.ext -Cprot -Cdir>> 

action: the protection of the file fn.ext in di r wi L L be set 
to prot. 

prot must be a 5-digit number, with each digit 
between and 7 (and.). 

The first digit means the access rights for group 
(the owner), the second for protection group 1 and 
so on. 



ac cess-ri g t hs : 



0=CHANGE-PR0TECTI0N ACCESS. 

1 =DELETEACCESS. 

2=WRITEACCESS. 

3=UPDATEACCESS. 

4=APPENDACCESS. 

5=C0PYACCESS. 

6=READACCESS. 

7=N0 ACCESS. 



protection-groups: 

0=the owner-directory. 

1=the ancestors of the owner directory. 

2=the descendants of the owner directory. 

3=those desc. of the owner's father, which are not 

in group 2 . 
4 = otherdi rectories. 

default: If directory is omitted, CurrentDirectory is as- 
sumed • 

If protection is omitted, the files will be protec- 
ted to 00???, where, '?' means unchanged. 

protection: CHANGE-PROTECTION access is neccessary to fn.ext, or 
directory must be owner of fn.ext. 
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11-2.31- Btdumg. 

format: ptdump -Cfn-C.ext -Cdi r -Cdumpf i le>>>> 

action: The files matching fn.ext in di r are dumped on the 
file dumpfile.MAS in a special format, which can be 
read by ■ pt load 1 . 

If dumpfile = "ptp", the files will be dumped on 
papertape . 

defaults: If fn, ext, di r, or dumpfile are omitted, "*", "*", 
CurrentDi re ct ory or the name of the directory are 
assumed. 

restrictions: Directories cannot be dumped. 

protection: Only files of which dir are the owner are dumped, 
and COPY-access is neccessary to these. 



H-2-32- gtload- 



f ormat : 
action: 



defaults : 



ptload {file -Cdevice>> 

The directory, specified by 'device 1 and the direc- 
tory path from 'ptdump 1 , will be loaded with the 
files on the file 'file. MAS'. 

If the files already exists, they will not be 
overwritten, but the file will be read to the file 
•f i le-NEW - 

If file = "ptr", the files will be loaded from 
papertape reader- 
file = "ptr". 
device = device for Cur rent Di rect ory . 
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11-2.33. gunch. 

format: punch fn.ext -Cdir> 

action: aLL files matching fn.ext in 'dir 1 are punched on 
the paper-tape. 

restrictions: directories are not punched 

defaults: If ext is omitted, '*' is assumed, if dir is omitted 
CurrentDi rectory is assumed 

protection: only files with COPY-access are dumped. 



11-2-34. readdec. 

format: readdec fn.ext 



a ct ion : 



default: 
protect ion : 



Transfers a file from DEC-10 to Rikke, and gives it 

the name fn.ext in Cur rent Di rect ory . 

The transport must be initiated on DEC-10 by 

■copy RIKOUT: = fn.ext ( /I if not an ASCII-file) 1 . 

If the file exists on Rikke, it is overwritten. 



ext 



"BCPL" 



WRITE-access is neccessary to fn.ext if it exists. 



11-2-35. readgtr. 

format: readptr fn.ext -Cdi r> 



a ct ion : 



defaults : 
restrictions: 
protect ion: 



A file is read from papert ape-reader, and given the 
name 'fn.ext' in directory 'dir'. 

If fn.ext already exists in dir, you will be asked 

whether to unl ink,de lete or rename the old fn.ext, 

or give up the reading; if it does not exist, it 
will be created. 

dir = Current Di re ct ory . 

ext = 'DIR' il legal . 

If you want to create fn.ext, APPEND-access is 

necessary to dir. 

Access needed to un I i nk, de lete or. rename fn.ext- 

please look under the commands unlink, delete, or 

rename. 
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11-2-36- remwuid. 

format: remwuid -Cfn-C.ext -Cdir>>> 

action: the entry fn.ext is removed from dir, if the entry 
is Wrong-UID. 

defaults: Remove *.* in CurrentDi re ct ory with wrong UID. 

protection: WRITE-access is necessary to 'dir 1 . 

11-2-37- rename. 

format: rename fnl.extl fn2-C-ext2 -Cdir>> 

action: the entries matching fnl-extl in dir are renamed to 

fn2-ext2. 



default : 



if ext2 or dir is omitted, extl or Cur rent Di rect ory 
will be assumed. 



restrictions: either fn1 or extl must be a simple name (no *'s or 
?»s). 

If fn1 is extended, fn2 has to be "*" (meaning the 
same name) . 
If extl is extended, ext2 has to be "*". 

protection: UPDATE-ac cess is necessary to 'dir' to rename en- 
tries. - 



11-1-38- senddec- 

format: senddec fn-C.ext> 



act i on : 



def au It : 
protect i on: 



The file fn.ext in Cur rent Di rect ory is send from 

Rikke to DEC-10. 

The transport must be initiated on DEC-10 by 

•copy fn.ext = RIKIN: ( /I if not an ASCII-file) 1 . 

If the file exists on DEC-10, it is overwritten. 

ext = "BCPL" 

READ-access is neccessary to fn.ext 
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11-1-39. sort- 
format: sort-Cdir> 

action: The entries in the directory wi L L be sorted al- 
phabeti ca I ly . 

defaults: dir = Cur rent Di rect ory 

protection: UPDATE-ac cess is necessary to 'dir 1 

11-2-40. time, 
format : t i me 



act ion : 



current date and time is typed on Console 



11-2.41- tty. 

format: tty command 



action: 



comment : 



the commands specifies working-mode for the console. 
Legal command are: 

ctrlon : control-characters are output as control- 
characters* 

ctrloff: control-characters are typed as A CH, where 
CH=the character+64- 

the normal working-mode is ctrlon 
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11-2-42. t^oe. 

format: type -Cfn-C.ext -Cdir>>> 

action: The files matching fn.ext in dir will be typed on 
the console . 

Striking CTRL E while listing, will skip to next 
file. 

default: if fn is omitted, you will be asked to prompt the 
f i lename . 

if ext or dir is omitted, BCPL or Current Di rectory 
will be as sumed. 

restrictions: Directories , cannot be typed. Files with extension 
REL cannot be typed. 

protection: At least READ-access is needed to fn.ext 



11-2-43. unlink. 

format: unlink fn.ext -Cdi r> 

act ion : 



defaults : 



The entries matching fn.ext is removed from dir, but 
the file itself will not be deleted. 

If dir is omitted, CurrentDi rectory is assumed 



restrictions: directories cannot be unlinked. 
OWNER-f i les cannot be unlinked. 

protection: WRITE-access is necessary to 'dir 1 . 



11-2-44. users., 
format : users 



act i on : 



List all usernames on the console. 
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11- Li^E§£^ £2y£iD§i." 



This chapter contains an alphabetical list of all global routines 
and variables, which may be neccessary or just usefull for user- 
programs. Each item is briefly described, or an reference is given 
to a description elsewhere in this or other manuals. 

The library routines are included in user-programs by using the 
directive get "SysHdr" in the program. 

Globals 100-399 are for user- prog rams . 



505 AddBytesToFileCfd: 

435 AddToFileCfd3 

480 Alloclnt EntryCJ 

418 BytesFromFi leCfd] 

41 9 BytesToFileCfdD 

511 CheckNamedFi leCf,e, 

497 ClockCSH 

20 CloseCSH 

524 Concatenated , s2U 

44 Console 

529 CopyFSClS,0S] 



50 CopyStri ngCsl ,s2H 

500 CopyVecCvl ,v2,nD 

69 CurrentDirectory 

53 DiscardCfdD 

21 Endof CSD 

72 EqSCs1,s2: 

441 Fi ndHeadi ng[ . . . .] 

75 GiveUpCF,p1 ,..p12] 

416 InFromFi leCfdH 

71 Ini tVecCn, aO , . . . anil 



445 InsertCUCCc: 

432 IntCodeFromRawCS: 

8 InterruptC3 

41 Keyboard 

31 LevelC: 

43 LineBuffer 

39 LoadCfn,dir3 



•C7.4> 
-C7.4> 
■C5.1> 
■C7.4> 
<7.4> 
f d,text] 
Output 
chara c 
<7.1> 
Retu rn 
to s2, 
•C7.3> 
Equi va 
$ ( w h i 

do 
$) 

Copies 
I ocate 
Equiva 
$( f 
-C9-1 > 
C8D 
•C7.1> 
Compar 
retu rn 
C8II 
<5.1> 
-C7.4> 
Cal Is 
ve ct or 
n<=30. 
<4.1> 
<7.3> 
■C6.2> 
-C7.2> 
Yields 
(P reg 
<7.3> 
The f i 
loaded 



•C10.1 .2> 
s current date and time to 
ter stream S as a text. 

s the concatenation of string s1 
neither s1 or s2 is returned. 

lent to 

le not EndofCSD 

outcos,Next:is:: 

string s1 to s2. s2 must be al- 
d before the call, 
lent to 
or i=0 to n-1 do v2!i:=v1!i $) 



es BCPL-strings s1 and s2 and 
s true/ false 



NewVec(n), and initialises the 
to the following n+1 parameters, 



current stack-frame pointer 

ister), used by LongJump e.g 

le fn.REL in directory dir is 
, dir=fd of a directory. 
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32 LongJ ump[p, i3 



59 LookUpDi r[f n,ext, 

58 MakeNewFileC 

27 Map[n3 

438 MaxVecSizeC: 

36 NewVecCnH 

17 NextCSl 

499 NextBlock[S,v,n3 

80 NextChCSH 

87 NextNCSD 

525 NextSCSD 

450 OpenReadFi LeCf n,e 



451 OpenWri teFi L eCf n, 



18 0ut[S,x3 

520 OutBlock[S, v,n3 

84 0utD[S,n,d3 
83 Out F[S,F,p1 . ..p123 

81 OutLineCSl 

82 0utN[S,n3 

85 0ut0[S,n3 

86 OutOct [S,n,d3 
80 0utS[S,s3 
417 0utToFile[fd3 
530 Pack[From,To,n3 



46 
92 



dir3 
3 



66 PackStri ng[v, s3 



Printer 
Prompt [S3 



95 PromptNCS3 



J umps 
j unct i 
used 
c al L s, 
mechan 

•C10 
[83 
Same e 
<2.1> 
•C2.1> 
•C7.1> 
■C7.6> 
<!7.8> 
{7.8> 
•C7.8> 
xt,type,dir 
ReadNa 
OpenRe 
ext, type, mo 
Wri teN 
OpenWr 
<7.1> 
{7.6> 
<7.8> 
■C7.8> 
Equi va 
<7.8> 
•C7.8> 
•C7.8> 
•C7„8> 
-C7.4> 
The ve 
ea ch 
From ! ( 
vector 
in the 
ri gt h 
Pack d 
The ve 
th roug 
pa eked 
Noti ce 
Locate 
■C7.3> 
Equi va 
$( 

OutS 
Rese 
resu 
$) 

Equi va 
$( 

OutS 



to Label 
on with Lev 
to return 

w i t hout 
i sme . 
1 .2> 



i at level p. In con- 
el, LongJump may be 
from nests of routine 
invoking the Run- 



ffect as the map command-C8> 



3 

medFileCfn, 
adF i LeCf n,e 
d e , d i r 3 
amedF i LeCf n 
i teFi LeCf n, 



ext,type3-C10.1 -1 > = 

xt, type, Current Di rectory3 

,ext, ty pe, mode3 = 

ext, type, mode, CurrentDirector 



lent to OutCS, '*n'] 



ctor From contains one byte in 
ri gt h-haL f word of From!0 to 

2*n-1). These bytes are packed in 
To!0 to To!(n-1) with first byte 
Left byte, second byte in the 

byte, and so on. 

oes not allocate vector To. 

ctor v contains characters in v!1 

h v!(v!0)). These characters are 
as a BCPL- string in vector s. 
that PackString does not al- 
vector s. 



Lent to 

[Console, S3 
t CLi neBuf f e 
Ltis ReadS[ 

lent to 

[Console, S3 



r3 
3 
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45 Ptp 

42 Ptr 

405 PutBackCS,x] 

94 ReadNC: 

431 ReadNamedFileCfn,ext 

433 ReadSC] 

444 RemoveCUCCC] 

19 ResetCS] 

473 ReturnFDCfd: 

447 ReturnHeadi ng ChU 

454 ReturnStringCs] 

35 ReturnVec Cv, nil 

24 RunCroutine,pvec3 
1 StartC...: 

30 StopCF,p1 ,. ..p1 23 

25 StopGiveUpCF,p1 . -p12 



74 St reamErrorCU 

498 TimeCd, m,y, h,m, s, tH 

33 UnloadCiblock] 

531 Unpa ck [From, To, n'3 



67 Unpa ckStr i ng Cs, v3 

410 WordsFromBSCS] 

437 WordsToBSCS] 

429 Wr i teNamedF i LeC.f n,ex 



Reset CLi neBuf f er J 

resu It i s ReadNC] 
$) 

<7.2> 
•C7.2> 
■C7.1> 
<7.8> 
,type] {10.1 .1 > 
•C7.8> 
<4.1> 
<7.1> 
•C10.1 .2> 
LSI 
Equivalent to 

Ret.urnVecCs,<(s!0) rshift 8)/2D 
<2.1> 
•C3.1> 

<5.1> 
3 Equi va I ent to 

$( 

StopCF,p1 , ..p123 
G i veUpC'cannot continue"! 
$) 
■C7.7> 

Return day, month, year, hour, second 
and tenth-seconds in the L v- paramete rs . 
■C3.1> 

Reverse of Pack: The n words in vector 
From!0 to From!(n-1) is unpacked with 
one byte rigth justified in each word 
of To!0 to To! <2*n-1) . 
Unpack .does not allocate vector To. 
Reverse of PackString 
-C7.3> 
<7.3> 
t, type, mode! -C10.1 -1> 
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13- The Character Set. 



The only devices attached to the system which provide information 
in Legible characters are the console and the line printer. Both 
of these have an ASCII character set (the printer with some minor 
oddities). The internal character code used in the system is 
ASCII, in the following sense: 



1 - The 


codes 


in 


.-C1 3 - 1 > 


2. The 


codes 


Console a 


9 : 


( »*t' 




te rs 


10: 


( '*n' 


11 : 


empty 


12 


:('*p» 




this 


13 : 


car r 




from 




ted t 




most 




on ly 


3. 0th 


er cod 



32-127 have standard ASCII interpretations as given 

9-13 are format codes which are output as follows (by 
nd Printer-C7 .3>) : 

) tabulator, so many spaces that the number of charac- 
on current line is divisible by 10. 
) car return followed by line feed. 

) car return followed by form feed, on the console 

i s ten I i ne feeds - 

eturn only- It is not possible to input this character 

the keyboard, since car return is immediately conver- 
o '*n'. In this fashion the return key receives its 

natural interpretation, and texts in internal ASCII 
contain one character per newline. 
es have no meaning (are illegal). 



Texts created in the editorL7H will be in internal ASCII- Existing 
ASCII text, e.g. on imported paper tape, read into the editor, may 
be converted to internal ASCII by using the gf command to select 
i nput . 

The Keyboard stream can deliver any value in the range 0-127 (ex- 
cept 13 as described above , and the control characters described 
in -C5-1>). This is utilized by LineBuffer, and user programs may 
also use the control characters (refer to Delta Data manuals). 

The Console and Printer streams both mask off parity bits, treats 
codes 32-127 as ordinary characters, and treat codes 9-13 ac- 
cording to the above description. Printer ignores any other codes, 
whereas Console passes them on. Thus the control characters for 
the Delta Data screen may also be used on output, but a switch can 
cause the them to be output as legible characters on the screen. 

The stream function Int code FromRaw<7 -3> is used to convert ASCII 
texts which contain parity bits or characters unknown in the in- 
ternal code to internal ASCII. It creates streams which mask off 
parity bits and then filters illegal characters. 



13 



-60- 



13-1- The ASCII character- code* 



The following table gives 


the de c i ma I va I ues 


and g 


^aph i cs 


characters available 


on t he 


RIKKE implementation of BCPL- 





32 


SPACE 


64 


a 


96 


* 


1 


33 


i 


65 


• A 


97 


: a 


2 


34 


" 


66 


■ B 


98 


b 


3 


35 


# 


67 


: C 


99 


c 


4 


36 


$ 


68 


D 


100 


d 


5 


37 


% 


69 


E 


101 


e 


6 


38 


& 


70 


F 


102 


f 


7 


BELL 39 


i 


71 


G 


103 


g 


8. 


BACKSPACE 40 


( 


72 


H 


104 


h 


9 


TAB 41 


) 


73 


I 


105 


i 


10 


NEWLINE 42 


• 


74 


J 


106 


J 


11 


43 


+ 


75 


K 


107 


k 


12 


NEWPAGE 44 


/ 


76 


L 


108 


I 


13 


CR 45 


- 


77 


: M 


109 


m 


14 


SO 46 


. 


78 


N 


110 


n 


1 5 


SI 47 


/ 


79 





111 





16 


48 





80 


P 


112 


P 


17 


49 


1 


81 


: Q 


113 


: q 


18 


50 


2 


82 


R 


114 


r 


1 9 


51 


3 


83 


S 


115 


s 


20 


52 


4 


84 


T 


116 


t 


21 


53 


5 


85 


' u 


117 


: u 


22 


54 


6 


86 


V 


118 


V 


23 


55 


7 


87 


: W 


11 9 


w 


24 


56 


8 


88 


X 


120 


X 


25 


57 


9 


89 


: Y 


1 21 


■ y 


26 


58 




90 


Z 


122 


z 


27 


ESC 59 


/ 


91 


C 


1 23 


■C 


28 


60 


< 


92 


\ 


124 


I 


29 


61 


= 


93 


: 1 


125 


> 


30 


62 


> 


94 


A 


126 


~ 


31 


63 


7 


95 


_ 


1 27 


DEL 



of the 
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14. Deadstart of R IKKE/Mat h i Ida . 



The procedure to Deadstart both RIKKE and Mathilda is given here. 
It is assumed, that power is on, on both RIKKE, WideStore, Mathil- 
da and the Disc-drives. 

RIKKfE-j)e.adStart . 

1) press STEP on RIKKE control panel. 

2) insert the small deadstart tape (usually blue) in 
RC2000, and press RESET. 

3) press DEADSTART button on RIKKE control panel. 
Now the tape will be read in. 

4) if you want to use default deadstart, type anything but 
'no 1 when promted on TTY, else contact system-program- 
me rs . 

5) Login 



Mathilda DeadStart: 

1) press STEP on Mathilda control panel. 

2) press DE ADST ART-butt on. 

If the machines won't deadstart, it may help to power them down 
and up again. 

NQI§ : This must only be done to Mathilda, WideStore and RIKKE. 
Powering the disks down and up must be left to system-programmers 
or t echni c i ans. 

Mathilda must not be powered up after RIKKE is deadstarted, as 
this will cause WideStore to start strange b I ock-t ranf e rs . 
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